home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 418_02 / install < prev    next >
Encoding:
Text File  |  1994-03-02  |  6.1 KB  |  144 lines
  1. To build RasMol version 2.3
  2.  
  3. UNIX X11:
  4. ==========
  5. [1] Modify the contents of the Makefile to determine your local C compiler,
  6.     compiler and linker options. The default set up is for an 8bit UNIX
  7.     workstation with the X11 shared memory extension, compiled using the
  8.     GNU C Compiler. Changing the line "CC=gcc" to "CC=cc" will use the
  9.     machines native compiler but will require changing "CFLAGS" for your
  10.     platform.
  11.  
  12.     RasMol may be build for E&S workstations using the command "make esv".
  13.  
  14.     Alternatively (or if the first method fails), type "xmkmf" to generate 
  15.     a Makefile for your particular system from the included Imakefile!
  16.  
  17.     A common problem is that SUN OpenWindows keeps its include files in the
  18.     directory /usr/openwin/include/X11, hence the compiler directive 
  19.     -I/usr/openwin/include must be added to CFLAGS.
  20.  
  21. [2] Modify the #defines in the file rasmol.h (see below)
  22.         Note: IBMPC should not be defined.
  23. [3] Compile the program using the UNIX make utility. (i.e. type "make")
  24. [4] Place the 'rasmol' executable on the execution PATH, i.e. /usr/local/bin
  25. [5] Install rasmol.hlp as /usr/local/lib/rasmol/rasmol.hlp (or at a loctaion
  26.     indicated by the environment variable RASMOLPATH).
  27. [6] If you have the UNIX utilities "uncompress" or "gunzip" ensure they are
  28.     on the user's default PATH.
  29. [7] Set the environment variable RASMOLPDBPATH to the directory containing
  30.     the Broohaven PDB database, if one exits.
  31. [8] Place any system wide initialisation parameters into the file "rasmolrc"
  32.     in the directory pointed to by RASMOLPATH.
  33. [9] It is possible to set-up RASMOLPATH and RASMOLPDBPATH each time the 
  34.     program is running by renaming rasmol to rasmol.exe, and using a script
  35.     similar to the following.
  36. [10] If appropriate place "rasmol.1" or "rasmol.0" in the appropriate place
  37.      for UNIX man pages, and optionally place "rasmol.html" somewhere in 
  38.      your WWW hierarchy (if available at your site).
  39.  
  40. ===========================================================================
  41. #!/bin/sh
  42. RASMOLPATH=/usr/common/lib/rasmol
  43. export RASMOLPATH
  44.  
  45. RASMOLPDBPATH=/data/brookhaven 
  46. export RASMOLPDBPATH
  47.  
  48. rasmol.exe $*
  49. ===========================================================================
  50.  
  51.  
  52. MS Windows v3.1:
  53. ================
  54. [1] Use Makefile.pc instead of Makefile, by copying it to MAKEFILE.
  55. [2] Modify the contents of the Makefile to determine your local C compiler,
  56.     compiler and linker options. 
  57. [3] Modify the #defines in the file rasmol.h (see below)
  58.         Note: EIGHTBIT, INVERT and IBMPC should all be defined
  59.               MITSHM, TERMIOS and DIALBOX should not be defined.
  60. [4] Compile the program using the Microsoft Optimizing C Compiler Version
  61.     7's (or Microsoft Visual C++'s) NMAKE program under MS-DOS.
  62. [5] Copy both the executable RASWIN.EXE, RASMOL.HLP and RASWIN.HLP to an
  63.     appropriate directory.
  64. [6] Install the program in MS Windows using the New option of the Program
  65.     Manager's File Menu. Set the Description of the Program to "RasWin v2.3"
  66.     and the Current Directory, to the directory containing the files.
  67. [7] Install the RasMol Help file using the New option of the Program
  68.     Manager's File Menu. Set the Description to "RasWin Manual", the
  69.     command to "C:\WINDOWS\WINHELP RASWIN.HLP" and the working directory
  70.     to the appropriate directory.
  71.  
  72.  
  73.  
  74. VAX/VMS
  75. =======
  76. [1] Modify the #defines in the file rasmol.h (see below)
  77.         Note: IBMPC, MITSHM and TERMIOS should not be defined.
  78. [2] If your VAX site has an MMS license type the command "MMS",
  79.     otherwise use the DCL build script by typing "@build.com"
  80. [3] The program may be run by typing "RUN RASMOL.EXE", the X Windows
  81.     server is specified by a VMS command of the form:
  82.     SET DISPLAY/CREATE/TRANSPORT=TCPIP/NODE=<hostname>
  83.  
  84.  
  85.  
  86.  
  87. COMPILATION DIRECTIVES
  88. ======================
  89.  
  90. The file rasmol.h contains a number of #define directives that control
  91. the runtime behaviour of the program. The following directives may be
  92. defined or undefined to suite the local site.
  93.  
  94. EIGHTBIT    This determines whether RasMol will display and produce
  95.         8bit or 32(24) bit output. By default this symbol is defined
  96.         producing images with up to 256 colours. This symbol must 
  97.                 be defined if IBMPC is defined.
  98.  
  99. DIALBOX        This enables the use of a dials box, that is connected 
  100.         using the X Window System XInput extension. This option
  101.         requires that the program be compiled with the Xinput and
  102.         Xext libraries. Note: libXinput is called libXi on SGI 
  103.         machines, so requires the compiler option -lXi!
  104.  
  105. MITSHM         This option enables the use of the X Window System MIT shared
  106.         memory extension. This enables images to be displayed faster
  107.         when RasMol and the X11 server are running on the same host.
  108.         This option requires the program be compiled with the Xext
  109.         library. This is now enabled by default.
  110.  
  111. TERMIOS        This directive enables the command line processing on UNIXs
  112.         that support the termios terminal handling routines. By 
  113.         leaving this symbol undefined, RasMol omits the interactive
  114.         command line interface. Undefining is not recommended!
  115.  
  116. INVERT          This determines whether the image should be rendered upside-
  117.         down or the right way up. Due to to wonders of MS Windows 
  118.         this must be defined in IBMPC is defined.
  119.  
  120. ISQRT        This enables the use of the integer square root function in
  121.         the program. This is enabled by default. It was added to
  122.                 avoid a compiler bug on SUN 386i machines. This should also
  123.         be commented out for DEC Alpha machines in native 64bit mode.
  124.  
  125. IBMPC           This determines whether the program is intended to run on an
  126.                 IBM PC or compatible under MS Windows or a UNIX workstation.
  127.                 By default, this option is disabled. If this option is defined
  128.         the options EIGHTBIT and INVERT must be defined, and TERMIOS
  129.         undefined.
  130.  
  131.  
  132. PROBLEMS, BUGS AND SOLUTIONS
  133. ============================
  134.  
  135. If you have any comments on the installation and implementation of RasMol
  136. please send me e-mail "rasmol@dcs.ed.ac.uk" or to the contact address given
  137. in the README file. Any additional patches, fixes or code will gladly be
  138. included in the next release of RasMol. I'm particularly interested in the
  139. problems of sites with different hardware.
  140.  
  141.  
  142. Roger
  143. --
  144.